home *** CD-ROM | disk | FTP | other *** search
/ Libris Britannia 4 / science library(b).zip / science library(b) / DJGPP / CBGRX103.ZIP / contrib / libgrx / 1st_read.me < prev    next >
Text File  |  1993-12-06  |  9KB  |  205 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.           Overview:
  9.  
  10.           This package contains a replacement graphics library for DJGPP,
  11.           named "LIBGRX". It supports EGA, VGA, 8514/A compatible, and S3
  12.           based PC graphics adapters in 16, 256, and 32768 color modes.
  13.           Support for mono EGA/VGA, Hercules (the "original" monochrome)
  14.           should be coming soon. The library supports (among other things):
  15.  
  16.              - an unlimited number of graphics drawing areas (called
  17.                contexts) both in video and system RAM.
  18.              - adjustable clipping regions for contexts.
  19.              - a rich set of graphics primitives.
  20.              - a library of loadable bit-mapped fonts.
  21.              - user to screen coordinate transformations.
  22.  
  23.           The library is upward compatible with the original 256 color
  24.           DJGPP VGA graphics library. However, only the C functions are
  25.           supported, the 'GrRegion' C++ class is not included in LIBGRX.
  26.  
  27.           The library is distributed in the form of three archives:
  28.  
  29.              CBGRX102.ZIP   - the library files, sources, include files,
  30.                               drivers, documentation. For most users this
  31.                               archive should be sufficient.
  32.              CBGRD102.ZIP   - the WordPerfect (tm) documentation of the
  33.                               library formatted for HP LaserJet and
  34.                               PostScript printers. Download this file only
  35.                               if (1) you have one of the above printers,
  36.                               and (2) you have no other way of dealing with
  37.                               WP files.
  38.              CBGRF102.ZIP   - the full compliment of X11R4 fonts for
  39.                               LIBGRX. For most applications the subset
  40.                               included in CBGRX102.ZIP should be
  41.                               sufficient.
  42.  
  43.           The LIBGRX graphics library is copyright: (c) 1992 Csaba Biegl,
  44.           820 Stirrup Dr, Nashville, TN 37221. Additionally, some modules
  45.           were derived from DJGPP code copyright: (c) DJ Delorie, 24
  46.           Kirsten Ave, Rochester NH. 03867-2954. Most of the fonts included
  47.           with the library originate from the MIT X11R4 distribution.
  48.           Consult the appropriate copyright text (in the files
  49.           "copying.cb", "copying.dj", and "copying.mit", respectively) for
  50.           further information.
  51.  
  52.  
  53.           Installation:
  54.  
  55.           The library is distributed in the form of a 'ZIP' archive, it
  56.           should be unarchived (use the '-d' option) in the directory where
  57.           DJGPP was installed. This will place the files of the archive
  58.           into a directory tree created under 'CONTRIB/LIBGRX'.
  59.  
  60.  
  61.  
  62.  
  63.  
  64.           The 'makefile' in the base directory can be used to install the
  65.           header and library files in the standard DJGPP include and
  66.           library directories by issuing the "make install" command. NOTE:
  67.           this will work only if you unarchived the package in the
  68.           directory where DJGPP is installed. Alternatively, you can use
  69.           the header and library files in their original location, but then
  70.           you have to supply 'gcc' with the proper include and library
  71.           paths.
  72.  
  73.           The same graphics driver you have been using for 256 color VGA
  74.           modes can be used with LIBGRX. This means that (at least for now)
  75.           you don't have to change your GO32 environment variable. The
  76.           documentation describes how to use (or create -- if you have an
  77.           unsupported card) the 16 color EGA/VGA drivers or the new,
  78.           programmable drivers. 
  79.  
  80.           There is one more environment variable which has to be set: the
  81.           directory where the fonts belonging to LIBGRX were installed. For
  82.           example: if you installed DJGPP in "c:\djgpp" and unarchived the
  83.           package in that directory, you would have to issue the command:
  84.  
  85.           SET GRXFONT=c:\djgpp\contrib\libgrx\fonts
  86.  
  87.           This completes the installation procedure. You can now rebuild
  88.           your application(s) with the LIBGRX library. The changes to
  89.           accomplish this are minimal:
  90.  
  91.            (1) Change the "#include <graphics.h>" and "#include <mouse.h>"
  92.                lines in your program to "#include <grx.h>" and "#include
  93.                <mousex.h>", respectively.
  94.  
  95.            (2) Link with "-lgrx" instead of "-lgr".
  96.  
  97.           Your program should work exactly the same as before. Consult the
  98.           documentation for the new features in the LIBGRX graphics
  99.           library.
  100.  
  101.           The LIBGRX graphics library can also be used in Turbo C programs.
  102.           The Turbo C library is not included in this distribution, but you
  103.           can build it by typing:
  104.  
  105.                make turboc
  106.  
  107.           in the directory where LIBGRX was installed. The Turbo C version
  108.           uses the environment variable ("GRXDRV") for specifying the
  109.           graphics driver, but the syntax is similar to the one used in
  110.           DJGPP. (NOTE: there is no need for the "driver" keyword!!)
  111.  
  112.               SET GRXDRV=<driver file> [gw <width>] [gh <height>] ...
  113.  
  114.           The Turbo C version supports only those resolutions which do not
  115.           require video RAM paging: 320x200 in 256 color mode, and up to
  116.           800x600 in 16 color modes.
  117.  
  118.  
  119.  
  120.  
  121.  
  122.           Directories:
  123.  
  124.           Successful unarchiving of the package should create the following
  125.           directories under the base directory where LIBGRX was installed:
  126.  
  127.             DOCS:             documentation files. These are provided both
  128.                               in WordPerfect (tm) 5.1 and plain DOS text
  129.                               format.
  130.  
  131.             DRIVERS:          additional graphics drivers for DJGPP.
  132.  
  133.             EVENTS:           an interrupt-driven mouse and keyboard event
  134.                               queue library for both Turbo C and DJGPP.
  135.  
  136.             FONTS:            loadable bit-mapped fonts for LIBGRX.
  137.  
  138.             INCLUDE:          public (externally used functions, variables,
  139.                               etc..) include files.
  140.  
  141.             LIB:              pre-built libraries for DJGPP.
  142.  
  143.             SRC:              LIBGRX sources
  144.  
  145.             TEST:             test programs 
  146.  
  147.             UTILS:            utilities for displaying fonts, etc...
  148.  
  149.  
  150.           Documentation:
  151.  
  152.           Some of the documentation files (mostly the user's manuals) in
  153.           the DOCS directory were written using WordPerfect (tm) version
  154.           5.1. These files were formatted for HP Laserjet II (or better)
  155.           printers. The remaining files (mostly the ones describing the
  156.           internals of the library) are plain ASCII files.
  157.  
  158.              The original WP files have the extension ".WP5".
  159.              The ASCII document files have the extension ".DOC".
  160.  
  161.           The ".DOC" files for those documents where a ".WP5" file is also
  162.           present were generated by converting the WP file to DOS text file
  163.           format. No particular effort was made to try to align, break up
  164.           nicely, etc.. the resulting text. These files should give
  165.           acceptable printouts on 132 column printers, but they may have to
  166.           be formatted for 80 column printers.
  167.  
  168.           There is an additional archive named "cbgrd102.zip" which
  169.           contains the WP documents formatted for LaserJet (extension:
  170.           ".LJ2") or PostScript (extension: ".PS") printers. These files
  171.           have not been included in the basic distribution because of
  172.           archive size considerations. These files are suitable for
  173.           printing on any Laserjet II (or better) or PostScript printer
  174.           just by typing:
  175.  
  176.  
  177.  
  178.  
  179.  
  180.                COPY /B <file>.lj2 prn
  181.                       -- or --
  182.                COPY /B <file>.ps prn
  183.  
  184.           No font cartridges are needed for the LaserJet printers as the
  185.           ".LJ2" files already contain the necessary downloadable fonts.
  186.  
  187.           A brief overview of the contents of the documentation files
  188.           included in the 'DOCS' sub-directory:
  189.  
  190.               1ST_READ.WP5:   this file in WordPerfect (tm) format.
  191.  
  192.               DRIVERS.WP5:    guide to writing graphics drivers for
  193.                               unsupported adapters.
  194.  
  195.               EVENTS.WP5:     manual for the event queue library
  196.  
  197.               INTERNAL.DOC:   internal details of the library and
  198.                               recompiling instructions
  199.  
  200.               LIBGRX.WP5:     user's manual for the graphics library
  201.  
  202.               MISSING.DOC:    listing of features and functions not
  203.                               implemented in this beta release
  204.  
  205.               TESTS.DOC:      a brief description of the test programs